home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / mus / misc / DelfScope.lha / DelfScope / DelfScope.readme < prev    next >
Encoding:
Text File  |  2000-10-03  |  4.0 KB  |  107 lines
  1. Short:  oscilloscope/analyzer for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/misc
  4.  
  5.  $VER: DelfScope 0.1 (Tue 03-Oct-2000)
  6.  
  7.  
  8.  #features
  9.    -reads audio data from Delfina input connector (external source)
  10.     or from a sound player program (AHI, DelfSF etc.)
  11.  
  12.    -realtime displays:
  13.      - stereo level meter
  14.      - stereo oscilloscope
  15.      - spectrum analyzer
  16.  
  17.    -can use any native Amiga screen mode (no CGFX support, sorry)
  18.  
  19.    -free software (full source code included, of course)
  20.  
  21.  
  22.  #requirements
  23.    -CPU 68020+
  24.    -AmigaOS V37+
  25.    -Delfina DSP board
  26.  
  27.    -developed on: A1200 (68030+882 @ 40MHz, 16MB Fast, Delfina1200 DSP)
  28.  
  29.  
  30.  #how to use it
  31.    Connect an external audio source (CD player, TV etc.) to your Delfina's
  32.    input or launch your favourite sound player program. Start DelfScope.
  33.    These options can be used:
  34.  
  35.    MODEID   / -m    screen mode ID.
  36.                     if omitted a reqtools screenmode requester appears.
  37.                     specify a decimal or hexadecimal (prefix $ or 0x) value.
  38.                     (example: MULTISCAN:Productivity - 233508 or 0x39024)
  39.                     the visible screen size should be at least 640x480 pixels.
  40.                     NOTE: only native Amiga modes (ECS/AGA) are supported!
  41.  
  42.    INPUT    / -i    name of the DelfModule to use as source.
  43.                     (default: "Connectors" - Delfina's input connector)
  44.                     here you can specify the name of the DelfModule that
  45.                     supplies DelfScope with input data. use the "listmod"
  46.                     command while you run a particular Delfina program to
  47.                     find out the name of its DelfModule. some examples are:
  48.                     "14Bit-NotePlayer" (AHI for DeliTracker by Chris Hodges),
  49.                     "DelFX", "DelfSF", "DelfAIFF", "DelfMPEG".
  50.                     NOTE: the names are case-sensitive!
  51.                     and unless you're a lucky owner of a Delfina Plus with
  52.                     128K memory / 74MHz DSP you will not be able to run
  53.                     DelfMPEG and DelfScope at the same time.
  54.  
  55.    Use these keys on the DelfScope screen:
  56.  
  57.    Esc      quit
  58.    Space    pause / continue
  59.    o        oscilloscope mode
  60.    s        spectrum analyzer mode
  61.    1...9    set redraw rate (lower=faster)
  62.    + -      increase / decrease input gain (for "Connectors" input only)
  63.  
  64.  
  65.  #technical stuff
  66.    -The width of the oscilloscope display depends on the vertical refresh
  67.     rate (fps). On slower screen modes (e.g. PAL - 50 Hz) the display is
  68.     wider so that all input data can be visualized.
  69.  
  70.    -The spectrum analyzer employs a 1024-point FFT routine that runs on the
  71.     DSP (adapted from Motorola example sources).
  72.  
  73.    -The plot routines (written in assembly language) are pretty simple and
  74.     use brute force in order to be fast. They only work with native screen
  75.     modes because they write directly into chip memory.
  76.     Anybody interested in better/more flexible plot routines? Then just
  77.     take my sources and modify them as you want.
  78.  
  79.  
  80.  #known problems
  81.    -DelfScope sometimes simply freezes my Amiga system, so don't work on
  82.     any precious data in the background - you have been warned!
  83.     This might be a "Delfina bug" of some kind, but currently I have no idea
  84.     how to solve this problem. :-(
  85.  
  86.  
  87.  #author
  88.    mailto: smack@smack.de
  89.  
  90.    DelfScope - oscilloscope/analyzer for Delfina DSP
  91.    Copyright (C) 2000  Michael Henke
  92.  
  93.    This program is free software; you can redistribute it and/or modify
  94.    it under the terms of the GNU General Public License as published by
  95.    the Free Software Foundation; either version 2 of the License, or
  96.    (at your option) any later version.
  97.  
  98.    This program is distributed in the hope that it will be useful,
  99.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  100.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  101.    GNU General Public License for more details.
  102.  
  103.    You should have received a copy of the GNU General Public License
  104.    along with this program; if not, write to the Free Software
  105.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  106.  
  107.